home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / gtgap151.zip / GTGAP.DOC < prev    next >
Text File  |  1990-02-13  |  17KB  |  330 lines
  1.  
  2.              The GTGap! Multi-DoorFile Conversion Utility for GT Power
  3.                       version 1.51  -  February 13, 1990
  4.  
  5.                        Copyright 1989 by Jason Cory Wright
  6.                  Sysop of The Rising Connection  (615) 531-8789
  7.         located in Knoxville, TN running GTPower 15 - NetNode 070/002
  8.       1200/2400/9600/19200 8N1  24 hours  7 days - Hayes 9600 V-Series
  9.  
  10. - VERSION 1.50 HAS LOTS OF CHANGES - PLEASE READ GTGAP150.!!! for MORE
  11.   INFORMATION THAT IS EXTREMELY IMPORTANT!!!
  12.  
  13.    -----   THE GTGAP is a GT POWER Version 15.XX utility   ------
  14.  
  15. The GTGap! is a Multi-DoorFile converter for GT Power that will allow GT
  16. to run Gap, QuickBBS/RBBS (Dorinfo), Wildcat!, Doorway, & PCBoard v14 doors.
  17. PCBoard v12.1 doors will also run with 1 extra (quick!) step.  Entire
  18. BBS systems are supported in v1.50 -- WWIV and QuickBBS.  See
  19. GTGAP150.!!! for more information!
  20.  
  21. Shareware Notice
  22. ----------------
  23. The GTGap! is distributed under the Shareware concept.  I encourage you to
  24. pass it along to your fellow GT Sysops and let them try it too.  I wanted to
  25. be able to keep track of how many people are using The GTGap! and at the same
  26. time, let them personalize their copy for all their users.  Since I was asking
  27. for a $10 donation from the start (when it was just a DOOR.SYS converter), I
  28. kept adding more and more features into it until I thought it looked good
  29. enough to let everyone use.  I personally think $10 is a very reasonable price
  30. for a multi-faceted converter that offers you full support over the GT Net and
  31. full access to The Rising Connection, Home of The GTGap! plus customization
  32. of your copy via a registration number, removal of the 5 second delay after
  33. The GTGap is finished, and activation of the Super Indexing feature
  34. mentioned in GTGAP151.!!!
  35.  
  36. Therefore, I have given you a copy of The GTGap! to use for a
  37. period of not more than 21 days (3 WEEKS) from the time you first use the
  38. program.  It is an UNREGISTERED copy though.  If your registration number is
  39. plugged into the configuration file, each time a user goes into a door that
  40. was converted by The GTGap!, he/she knows you have registered your copy since
  41. your BBS name is there!  It helps me to keep you informed for the LIFETIME of
  42. your use of the program.  There will never be an upgrade fee for The GTGap!
  43. and your registration number will be valid forever!  Just print the file,
  44. REGISTER.FRM to your printer (or handwrite one that includes ALL INFORMATION)
  45. and send it to me.  Expect your registration number within 10 days.
  46.  
  47. If there is ever a bug or if you ever need a custom file, then registered users
  48. will have their wished granted ASAP!  Support can be obtained thru GT NetMail
  49. or by calling my BBS.  My NetNode number is 070/002. Address your mail
  50. to Cory Wright or you can publicly contact me in lots of the GT Conferences.
  51. If you have decided that The GTGap! is not for you, then please upload it to
  52. someone else and destroy your copy.  You shouldn't use it for more than 3 weeks
  53. (21 Days) without registering your copy. I am also available in the Sysop
  54. conference(s).
  55.  
  56. To register, use the REGISTER.FRM file within this archive & mail it to me.
  57. Registration numbers are your responsibility and should not be given to anyone.
  58. You will have an account made for your use on The Rising Connection.
  59. Please print out the REGISTER.FRM file (or handprint/type one legibly) with
  60. ALL of the information included.
  61.  
  62.  
  63. Use
  64. ---
  65. The use of The GTGap is very simple, but one other file is necessary.
  66. This file is a familiar, straight text configuration file that you
  67. are used to from using DOORPCH/PCBoard doors.  It must be named GTGAP.CNF
  68. and must reside in the directory that GTPATH has been SET to.
  69. SET GTPATH=C:\GT will do this..  I am sure you already have done it.
  70. The GTGap! also looks for the GTUSER.BBS file in this directory.  They both
  71. must exist and be in correct form.
  72.  
  73.  
  74. THE CONFIGURATION FILE   --  THIS FILE HAS CHANGED IN v1.50!  *****
  75. ----------------------   -- PLEASE READ GTGAP150.!!! for important info!
  76. Your configuration file MUST be named GTGAP.CNF and MUST be in the directory
  77. that the GTPATH is SET to.
  78.  
  79. It contains these lines--all straight ASCII, each on a separate line:
  80.  
  81. *******************************************************************************
  82. If you have not registered yet, line 1 of the config file should be set to
  83. your BBS name and the registration # (on line 2) should be 0.  When you get
  84. your registration number, you need to change line #1 to match what I send
  85. you.  (Your registered version will have a # after your BBS name).  Put your
  86. registration number on line 2 when you get it.  Until then, keep it 0.
  87. *******************************************************************************
  88.  
  89. The Rising Connection #1  <= The Name as given to you when you got your Reg #
  90. 0                       <= Registration Number (0 if not registered)
  91. Cory                    <= The Sysop's First Name
  92. Wright                  <= The Sysop's Last Name
  93. The Rising Connection   <= Your BBS Name as you want it in the doors.
  94. Y                       <= Screen Display on or off (Y or N)
  95. N                       <= Printer on or off (Y or N)
  96. Y                       <= Page Bell on or off (Y or N)
  97. Y                       <= Caller Alarm on or off (Y or N)
  98. COM1:                   <= Complete COM port name (COM1: or COM2: or whatever)
  99. N                       <= Actual Lock DTE rate (N if no com port lock speed)
  100. 50                      <= Security level of callers within door
  101. 1                       <= Node number (usually 1 I know, but for flexibility)
  102. 1                       <= Kickoff Time  **> See below
  103. 1                       <= Minutes to give when time has expired.  -*- See Below
  104. NETWORK                 <= NETWORK if you are networking, NONE if not
  105. HAYES                   <= HAYES if running a HAYES 9600 V-Series, NONE if not
  106. ON                  <= Windows will be activated with ON, and disabled with OFF
  107. YES                     <= YES if using GT 15.10 ; NO if using 15.01 or before
  108.  
  109.  
  110. **> GT automatically subtracts 5 minutes from the user's time if the user's
  111.     time threatens the event.  The last line of the configuration file is
  112.     there for your convienence.  If you feel like GT's 5 minutes is not enough
  113.     time or if you want to BE SURE that they get out in time, then you can set
  114.     this to the additional amount of time to subtract from the user's time
  115.     in the door.   Consider it as being a safety measure.  In other words,
  116.     (Time user has in GT) minus (Kickoff time in .CNF file) = Time in Door
  117.     If you feel safe and sound with GT's 5 min. buffer, then I would set this
  118.     to 1.  1 is the recommended setting found by my beta testers.
  119.  
  120. *- Some doors freak out when given a time of 0 (like Max Headroom).  If this
  121.    is set to 1 (or whatever), they are given 1 minute if they're time has
  122.    "expired".  For example, a user has 5 minutes left & it is nearing an event.
  123.    You have set your kickoff time to 5 minutes.  When he goes into the door,
  124.    it will say 0 minutes left.  If this door freaks out when given 0 minutes
  125.    for a time, you will have hung your board and missed the event.  With this
  126.    field set to 1, it would allow him 1 minute in the door, and he would be back
  127.    to the board with 4 minutes left.  If you do not use this, set it to 0.
  128.    Remember, this is the MINIMUM time passed to the door.
  129.  
  130. v1.43 addition *>>  The user's password and city, state, are taken from the
  131.                     USER.CTL file.  Even more info is used in v1.50!
  132.  
  133. -;-;-;-;-;--;-;-;-;--;-;-;-;-;---;--;-;-;-;--;-;-;---;--;-;-;--;;-;-;-;--;---;
  134. New feature in version 1.41 and above:
  135.  
  136. You may put /NODAT as the LAST parameter on the command line, and The GTGap!
  137. will not write a PCBOARD.DAT file.  Note that it only applies when you are
  138. using the 14 doortype.  Example:
  139. GTGAP 14 C:\GT /NODAT      or
  140. GTGAP 14 /NODAT
  141. -;-;--;-;-;-;-;-;-;-;-;-;-;-;-;-;-;-;--;-;-;-;-;-;-;-;-;-;-;-;-;-;--;-;-;-;-;-
  142.  
  143. *******************************************************************************
  144.    The GTGap! v1.5x has implemented MANY new features YOU NEED to know about
  145. *******************************************************************************
  146.  
  147. Version 1.50:
  148.    - Now can write DORINFOx.DEF  (where x is the node number) for QBBS doors
  149.                    CALLINFO.BBS for Wildcat! doors
  150.                    USERINFO.TXT for Milton Gameworks Doors like Planet Busters
  151.         along with DOOR.SYS     used by GAP
  152.         and        DOOR.SYS     for DOORWAY
  153.         plus ALL PCBOARD v14 files for PCBOARD version 14.x doors
  154.  
  155.    v1.50  ->  Runs WWIV and QuickBBS in a door! (YES, the actual BBS program)
  156.               See GTGAP150.!!! for more details.
  157.  
  158.   - Will now support PCBoard v12 doors with an added utility provided
  159.  
  160.         (RBBS will run on QBBS Dorinfo1.def files (etc.) that DO NOT depend
  161.          on the RBBS MESSAGES file!  If you see this in a RBBS door doc file,
  162.          then The GTGap will not be able to convert to it.)
  163.  
  164.    - Fully recognizes all events and compensates for the time left
  165.      including sysop-determined "kickout" time defined in the config file.
  166.      The sysop can now make The GTGap "kick" a user out of a door x minutes
  167.      before their time expires on GT to ensure that the event is run.
  168.      (Where x is a # of minutes that is set within the config file)
  169.      This field is recommended to be set to 1.
  170.  
  171.    - Also has a MINIMUM time to pass to door field.  This would be for doors
  172.      that lock when given a time of 0.
  173.  
  174.    - The PCBV option has been removed since it will run under PCBoard 14.
  175.  
  176.  *** REVISED COMMAND LINE Format!  ***************
  177.  
  178.      The GTGap! (v1.50) is now invoked with the command line as follows:
  179.  
  180.         GTGAP (Door Type) [Destination Path] [/NODAT]      []=optional
  181.  
  182.           where Door Type is either -
  183.             GAP         for GAP's DOOR.SYS
  184.             QBBS        for Dorinfox.def (Dorinfo1.def, etc) of QuickBBS
  185.             WC          for Wildcat!'s CALLINFO.BBS file
  186.             UI          for the USERINFO.TXT file of Planet Busters and such
  187.             DRWY        for DOOR.SYS for doors that require the user name
  188.                         to be in ALL CAPS  (otherwise--same as GAP)
  189.             14          for PCBOARD v14's files
  190.             WWIVGATE    for the batch file to run WWIV (GT-WWIV.BAT)
  191.             QBBSGATE    for the batch file to run QuickBBS (GT-QBBS.BAT)
  192.  
  193.  
  194.           where Destination path is the path to where you want the door file
  195.           written.  Can be either with or without the trailing backslash.
  196.           In other words, D:\GT is the same as D:\GT\
  197.           This field is optional and will default to the current directory
  198.           if not specified. (You don't have to use a * anymore)
  199.  
  200.     For example, to write a QBBS DORINFO1.DEF file to the GT subdirectory of
  201.     drive D:, you would enter:
  202.  
  203.         GTGAP QBBS D:\GT
  204.  
  205.     To write one to the current directory, you would enter:
  206.  
  207.         GTGAP QBBS
  208.  
  209.   Spaces are the only acceptable delimiters between command line options.
  210.  
  211. *****************************************************************************
  212. PCBOARD v12 instructions:
  213.  
  214. I picked up a little PD utility that lets me convert from version 14 of
  215. PCBOARD to version 12's .SYS file.  I have included it and here is how I use
  216. it.  BTW, I included a file PCB12.DAT that should be renamed to PCBOARD.DAT
  217. and put in your directory where you keep your PCBoard 12 files as explained
  218. below.
  219.  
  220. I have a directory named 12 off my GT directory.  I also found the information
  221. for the PCBOARD.DAT file in some docs I had.  So I made my own and stuck it in
  222. this directory.  You can grab a hold of a PCBOARD.DAT file for v12 with some
  223. other utility and stick it in a directory by itself.
  224. Then I run a batch file like this:
  225.  
  226. CD\GT
  227. GTGAP 14           (this writes the PCBOARD v14 files into my current GT dir)
  228. CD\GT\12           (Change to the v12 directory)
  229. CRUTCH C:\GT\PCBOARD.SYS  (Run the converter by specifying the INPUT
  230.                            PCBOARD.SYS file that GTGAP wrote into the \GT dir
  231.                            on the command line)
  232. Then run your PCBOARD v12 door!  Simple!
  233.  
  234. Many thanks go to the author for writing this program.  It is in no way a
  235. part of The GTGap! and registering the GTGap! has nothing to do with your
  236. use of this CRUTCH utility.  I assume no responsiblity for its actions or
  237. your losses -- I didn't write it.  I just found it and am using it for the
  238. few PCB 12 doors I have.  I would rather ditch the v12 format, but it is there
  239. for those older doors you guys want to run.  Carl M. Evans of The Vervan's
  240. War Board (Phone # in program) is the author.  Thanks again!
  241.  
  242.  
  243. Restrictions / Possible Errors
  244. ------------------------------
  245. The GTUSER.BBS file cannot be more than 1 line long (shouldn't be anyway).
  246.  
  247. ALL Y/N flags for the Page Bell, and the HAYES/NETWORK/NONE fields
  248. should be in upper case!
  249.  
  250. The GTGap! assumes that all connections are at 8N1.  There is no other way
  251. to detect 7E1 callers from what GT writes.  And surely, only a TINY portion,
  252. if any, should be at 7E1.
  253.  
  254. The GTPATH must be set!  The GTUSER.BBS file MUST be in that directory along
  255. with the configuration file, GTGAP.CNF.  The configuration file MUST BE NAMED
  256. GTGAP.CNF and MUST be in the GTPATH's directory
  257.  
  258.  
  259. Conclusion
  260. ----------
  261. The only real things I haven't let you configure were birthdays in
  262. Wildcat!'s CALLINFO.BBS file (everyone's is 1/1/1970)--Some of you are
  263. grateful I am sure and the user record number (fake of course, but record
  264. 2 if you are wondering) in the CALLINFO.BBS file.  If you run across a door
  265. for Wildcat! that actually uses record numbers instead of names.. (dunno why!)
  266. then chuck the door program.  Not worth it anyway....
  267.  
  268. I hope you can give me suggestions on how to make The GTGap better.
  269. Contact me on my BBS anytime (number at top of documentation) and leave
  270. mail to Cory Wright or send me a post card if you would like.
  271.  
  272. Also, the DOOR.SYS format is supported by Marshall Dudley's DOORWAY program.
  273. The new 2.05 version of DOORWAY can make any program into a door and even
  274. can make those using direct screen writes into a door!  That's about 99.9%
  275. of all programs being made into a door!  You can pick this file up on my
  276. BBS also under the name DRWY205.ZIP in the file bases.
  277.  
  278. Now go out and get some GAP, QBBS, RBBS, Milton (USERINFO.TXT) Games like
  279. Planet Busters, Wildcat!, and PCBOARD v12 and 14 doors, or make your own with
  280. DOORWAY and have fun!  Even run WWIV or QuickBBS in a door!!!
  281.  
  282. Thanks,
  283. Cory Wright
  284. 8726 Farmington Drive
  285. Knoxville, TN  37923
  286. Data:  The Rising Connection  (615) 531-8789  NetNode 070/002
  287.  
  288. Feel free to call me to report errors and suggestions for improvements!
  289.  
  290. I really need your comments as to how to make the program do more FOR YOU.
  291. If I don't get feedback, I cannot improve.
  292.  
  293. I will include any type of door file conversion into this program that you can
  294. give me ample information on.  I want this program to be your all-purpose door
  295. converter and I hope to support as many formats as I can.
  296.  
  297. Thanks
  298. ------
  299. The GTGap! was conceived, written, and compiled by myself, J. Cory Wright.
  300. Mr. Fred Jones of Diversions-I in Knoxville suggested the DOOR.SYS conversion
  301. and it snowballed from there as I tried to improve it as much as I could.
  302. I would like to thank Mr. Jones for his past and current willingness to
  303. beta test on his BBS.  Thorough beta testing helps to ensure the
  304. finest quality of programming.  Between the efforts of myself and Mr. Jones
  305. watchful eye for bugs, we are committed to making The GTGap! your all-purpose
  306. "GT to Anything" converter.  I also wish to thank my beta testers that are
  307. helping improve the program as we speak!
  308.  
  309. Instant access is granted to GT sysops via the garbled password(s) (14.03 and
  310. 15.00's).  Either one will work.
  311.  
  312. I look forward to hearing from everyone!
  313.  
  314. ------------------------------------------------------------------------------
  315. Disclaimer:  I, J. CORY WRIGHT, AM IN NO WAY RESPONSIBLE FOR ANY DAMAGES
  316. INCURRED BY THE USE OF GTGAP VERSION 1.5 WHETHER MONETARY OR OTHERWISE.
  317. I TAKE NO RESPONSIBILITY FOR THE WAY YOU USE GTGAP VERSION 1.5 OR FOR DAMAGES
  318. WHETHER MONETARY, PHYSICAL, TIME LOST, FILES LOST, EQUIPMENT FAILURE OR
  319. OTHERWISE INCURRED BY YOUR USE OF GTGAP.
  320.  
  321. This file should remain intact in its original form (.ZIPPED) but may be
  322. compressed by an equivalent compression program as long as all distribution
  323. files are included.  These include the GTGap program itself, the documentation,
  324. original and unmodified, and the .!!! history file along with the sample
  325. configuration file.  Also, the form for registering The GTGap!.
  326.  
  327. If you use The GTGap! for more than 21 days, or 3 weeks, you are obligated
  328. to send in the registration fee, a paltry sum of $10.
  329. ------------------------------------------------------------------------------
  330.